home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro138 / callrout.doc < prev    next >
Encoding:
Text File  |  1993-03-10  |  6.9 KB  |  175 lines
  1. Call Router v1.3
  2. Copyright (c) 1992-93 by RBK Software
  3. Distributed as ShareWare
  4.                ^^^^^^^^^
  5.  
  6. Notice!
  7. ------
  8. Call Router is distributed as Shareware. If you use this program beyond
  9. the customary two-week trial period, you must register it!
  10. By registering Call Router you help fund the future development of this
  11. software. You will also receive the feature rich registered version,
  12. printed documentation, and full access to our support BBS.
  13.  
  14.  
  15. Description
  16. -----------
  17. Call Router is a communications utility designed to help 'answer' your
  18. incoming phone calls based on their ring patterns. Call Router is
  19. designed to work with any standard phone line or with "RingMate",
  20. an add-on service offered by many local telephone companies (see below
  21. for description of RingMate).
  22.  
  23. If you run a BBS system and have only one phone line, Call Router is
  24. your solution! With the RingMate service, you can use the additional
  25. number as your BBS phone number. Call Router can detect within two rings
  26. which number is ringing. Utilizing the ERRORLEVEL settings returned by
  27. Call Router you can start your BBS or reset to wait for the next call.
  28.  
  29. With or without RingMate service, Call Router may be implemented in a
  30. variety of ways depending on what software you use. Call Router's
  31. flexibility allows for greater PC communications creativity.
  32.  
  33.  
  34. Starting Call Router...
  35. -----------------------
  36. The correct calling syntax is: CALLROUT comport [baud b] [rings r] [rm]
  37.  
  38.  comport - Specify COM port to be used: 1, 2, 3, or 4.
  39.            This must be entered as the first argument whenever Call
  40.            Router is started.
  41.  
  42.  baud b  - Optional baud rate specification.
  43.            Call Router's default is 2400 baud.
  44.  
  45. rings r  - Optional number of rings to count before program exit.
  46.            Default setting is 2.
  47.  
  48.      rm  - Indicates that RingMate service is active on the line.
  49.            The minimum rings setting is 2 while RingMate is active.
  50.            This argument is also optional.
  51.            Call Router's default is RingMate inactive.
  52.  
  53. The Call Router unregistered version sets the DOS ERRORLEVEL according
  54. to what it detects. There must be a call to an 'answering' program or
  55. some other routine from within a batch file to interpret the results
  56. returned from Call Router. Your answering program may be a bulletin
  57. board system, a FAX program, etc.
  58.  
  59. More on RingMate...
  60. -------------------
  61. RingMate is an add-on service offered through your local telephone
  62. company. The service adds an additional phone number to an existing
  63. line. When called, the new number sounds a distinctly different ring
  64. pattern. The original number retains its standard length ring. This
  65. allows the user to know which number was dialed.
  66.  
  67. Using Call Router with this service, you can use the additional number
  68. as a separate data number. Call Router will direct which 'answering'
  69. program is called through a simple batch routine. Call Router can reduce
  70. the need for an additional phone line hook-up by handling a call if
  71. another modem is calling.
  72.  
  73.  
  74. Call Router in action...
  75. ------------------------
  76.  
  77. To allow maximum flexibility, Call Router sets the appropriate DOS
  78. ERRORLEVEL based on what it determined from timing phone ring input.
  79. Call Router should be called from a batch file so that the DOS ERRORLEVEL
  80. condition set by Call Router can be tested.
  81.  
  82. Call Router sets the DOS ERRORLEVEL as follows:
  83.  
  84.  ERRORLEVEL 4 - Short ring detected (used with Ring Mate option)
  85.  ERRORLEVEL 3 - Standard ring detected.
  86.  ERRORLEVEL 2 - Timeout condition.
  87.  ERRORLEVEL 1 - Program error upon startup or initialization.
  88.  ERRORLEVEL 0 - Program ended normally.
  89.  
  90. It is the assumed here, that the user has a working knowledge of
  91. ERRORLEVELS and DOS batch file commands. See the accompanying files,
  92. CRDEMO.BAT and RMDEMO.BAT for examples of how Call Router can be used
  93. with both a standard phone line and those optioned with RingMate.
  94.  
  95. When Call Router is started, it initializes the COM port entered at the
  96. DOS prompt. If any errors are detected during initialization or there
  97. are errors in the arguments passed, the program ends setting the DOS
  98. ERRORLEVEL to 1. If all went o.k., the program installs it's interrupt
  99. driven interface in memory and waits for a phone call.
  100.  
  101. Once a ring is detected, Call Router starts to count incoming rings
  102. until it reaches the default of two or the number of rings specified
  103. upon startup by the 'rings' option. Please note that the overriding
  104. minimum 'rings' is two when RingMate detection is active.
  105.  
  106. As soon at the third ring is detected, the program will have made a
  107. ring type determination if the 'rm' or "RingMate" parameter was passed
  108. upon startup. The program would be ready to set the appropriate DOS
  109. ERRORLEVEL and exit (4 if RingMate, 3 if Standard). Call Router
  110. continues to count rings until the number rings equals the number rings
  111. set by the 'rings' parameter and exits setting ERRORLEVEL accordingly.
  112. If Call Router counts five seconds of silence any time after the first
  113. ring, it considers the call aborted or answered elsewhere and exits
  114. setting ERRORLEVEL to 2.
  115.  
  116. Call Router in Action (cont)...
  117. --------------------------------
  118.  
  119. In the case where RingMate is inactive ('rm' argument not used), the
  120. program will count the number of rings - either the default of 2 or the
  121. user-defined count provided by the 'rings' argument. When the rings are
  122. counted the program will exit setting ERRORLEVEL to 3. This setup would
  123. allow a call to be answered by voice within a certain number of rings or
  124. if allowed until your PC answers it.
  125.  
  126. To exit Call Router normally, press ESC. The open COM port will be
  127. properly closed. Call Router will set ERRORLEVEL to 0, indicating that
  128. the program ended normally.
  129.  
  130. Support
  131. -------
  132.  
  133. Any questions, suggestions, or comments may be addressed to:
  134.  
  135. The Data Place BBS - 24hrs.
  136. An official RBK software support and distribution site.
  137. (516) 859-1078 (300/1200/2400 BPS)
  138. Address E-mail to RBK Software.
  139.  
  140. Compuserve [70714,3020]
  141.  
  142. RBK Software
  143. 280-13 Belmore Avenue
  144. East Islip, NY  11730
  145.  
  146. Sorry, no voice support for unregistered users.
  147.  
  148.  
  149. Registering
  150. -----------
  151.  
  152. Send for the registered version of Call Router today, complete with
  153. printed documentation, shipping on 5¼" or 3½" diskettes, and 6-month
  154. voice support. We will bill you the $15 registration fee later!
  155.  
  156. Features: ■ Easy to use pull-down menu system.
  157.           ■ Time/Date controlled event execution.
  158.           ■ Starts other programs directly (with errorlevel setting option).
  159.           ■ Message send/receive option.
  160.           ■ Built-in help facility.
  161.           ■ Switchable screen-saver.
  162.           ■ Detailed call logging.
  163.           ■ Auto-dialer with phonebook.
  164.           ■ Full support.
  165.  
  166. Complete attached order form and mail to:
  167.  
  168.  RBK Software
  169.  280-13 Belmore Avenue
  170.  East Islip, NY  11730
  171.  
  172.  or you may register on-line on our support BBS 24 hours a day:
  173.  
  174.  The Data Place BBS (516) 859-1078 (300/1200/2400 BPS)
  175.